home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / Interfaces&Libraries / Universal / Interfaces / AIncludes / QD3DIO.a < prev    next >
Encoding:
Text File  |  1998-08-17  |  29.4 KB  |  1,085 lines  |  [TEXT/MPS ]
  1. ;
  2. ;    File:        QD3DIO.a
  3. ;
  4. ;    Contains:    QuickDraw 3D IO API                                                
  5. ;
  6. ;    Version:    Technology:    Quickdraw 3D 1.5.4
  7. ;                Release:    Universal Interfaces 3.2
  8. ;
  9. ;    Copyright:    © 1995-1998 by Apple Computer, Inc., all rights reserved.
  10. ;
  11. ;    Bugs?:        For bug reports, consult the following page on
  12. ;                the World Wide Web:
  13. ;
  14. ;                    http://developer.apple.com/bugreporter/
  15. ;
  16. ;
  17.     IF &TYPE('__QD3DIO__') = 'UNDEFINED' THEN
  18. __QD3DIO__ SET 1
  19.  
  20.     IF &TYPE('__QD3D__') = 'UNDEFINED' THEN
  21.     include 'QD3D.a'
  22.     ENDIF
  23.  
  24.     IF &TYPE('__QD3DDRAWCONTEXT__') = 'UNDEFINED' THEN
  25.     include 'QD3DDrawContext.a'
  26.     ENDIF
  27.     IF &TYPE('__QD3DVIEW__') = 'UNDEFINED' THEN
  28.     include 'QD3DView.a'
  29.     ENDIF
  30.  
  31. ; ******************************************************************************
  32. ; **                                                                              **
  33. ; **                                    Basic Types                                 **                                                    
  34. ; **                                                                              **
  35. ; ****************************************************************************
  36.  
  37. ; typedef unsigned char                 TQ3Uns8
  38.  
  39. ; typedef signed char                     TQ3Int8
  40.  
  41. ; typedef unsigned short                 TQ3Uns16
  42.  
  43. ; typedef signed short                     TQ3Int16
  44.  
  45. ; typedef unsigned long                 TQ3Uns32
  46.  
  47. ; typedef signed long                     TQ3Int32
  48.  
  49.     IF TARGET_RT_BIG_ENDIAN THEN
  50. TQ3Uns64                RECORD 0
  51. hi                         ds.l    1                ; offset: $0 (0)
  52. lo                         ds.l    1                ; offset: $4 (4)
  53. sizeof                     EQU *                    ; size:   $8 (8)
  54.                         ENDR
  55. TQ3Int64                RECORD 0
  56. hi                         ds.l    1                ; offset: $0 (0)
  57. lo                         ds.l    1                ; offset: $4 (4)
  58. sizeof                     EQU *                    ; size:   $8 (8)
  59.                         ENDR
  60.     ELSE
  61. TQ3Uns64                RECORD 0
  62. lo                         ds.l    1                ; offset: $0 (0)
  63. hi                         ds.l    1                ; offset: $4 (4)
  64. sizeof                     EQU *                    ; size:   $8 (8)
  65.                         ENDR
  66. TQ3Int64                RECORD 0
  67. lo                         ds.l    1                ; offset: $0 (0)
  68. hi                         ds.l    1                ; offset: $4 (4)
  69. sizeof                     EQU *                    ; size:   $8 (8)
  70.                         ENDR
  71.     ENDIF    ; TARGET_RT_BIG_ENDIAN
  72. ; typedef float                         TQ3Float32
  73.  
  74. ; typedef double                         TQ3Float64
  75.  
  76. ; typedef TQ3Uns32                         TQ3Size
  77.  
  78. ; ******************************************************************************
  79. ; **                                                                              **
  80. ; **                                    File Types                                 **
  81. ; **                                                                              **
  82. ; ****************************************************************************
  83.  
  84.  
  85. ; typedef long                            TQ3FileModeMasks
  86. kQ3FileModeNormal                EQU        0
  87. kQ3FileModeStream                EQU        $01
  88. kQ3FileModeDatabase                EQU        $02
  89. kQ3FileModeText                    EQU        $04
  90. ; typedef unsigned long                 TQ3FileMode
  91.  
  92. ; ******************************************************************************
  93. ; **                                                                              **
  94. ; **                                    Method Types                             **
  95. ; **                                                                              **
  96. ; ****************************************************************************
  97.  
  98. ; 
  99. ; *    IO Methods
  100. ; *
  101. ; *    The IO system treats all objects as groups of typed information.
  102. ; *    When you register your element or attribute, the "elementType" is the 
  103. ; *    binary type of your object, the "elementName" the ascii type.
  104. ; *    
  105. ; *    All objects in the metafile are made up of a "root" or parent object which
  106. ; *    defines the instantiated object type. You may define the format of your 
  107. ; *    data any way you wish as long as you use the primitives types above and the
  108. ; *    routines below.
  109. ; *
  110. ; *    Root Objects are often appended with additional child objects, called 
  111. ; *    subobjects. You may append your object with other QuickDraw 3D objects.
  112. ; *    
  113. ; *    Writing is straightforward: an object traverses itself any other objects 
  114. ; *    that make it up, then writes its own data. Writing uses two methods: 
  115. ; *    TQ3XObjectTraverseMethod and TQ3XObjectWriteMethod.
  116. ; *
  117. ; *    The TQ3XObjectTraverseMethod method should:
  118. ; *    + First, Determine if the data should be written 
  119. ; *        - if you don't want to write out your object after examining your
  120. ; *            data, return kQ3Success in your Traverse method without calling
  121. ; *            any other submit calls.
  122. ; *     + Next, calculate the size of your object on disk
  123. ; *     + Gather whatever state from the view you need to preserve
  124. ; *         - you may access the view state NOW, as the state of the
  125. ; *             view duing your TQ3XObjectWriteMethod will not be valid. You may
  126. ; *             pass a temporary buffer to your write method.
  127. ; *     + Submit your view write data using Q3View_SubmitWriteData
  128. ; *         - note that you MUST call this before any other "_Submit" call.
  129. ; *         - you may pass in a "deleteMethod" for your data. This method
  130. ; *             will be called whether or not your write method succeeds or fails.
  131. ; *     + Submit your subobjects to the view
  132. ; *     
  133. ; *     The TQ3XObjectWriteMethod method should:
  134. ; *     + Write your data format to the file using the primitives routines below.
  135. ; *         - If you passed a "deleteMethod" in your Q3View_SubmitWriteData, that
  136. ; *             method will be called upon exit of your write method.
  137. ; *
  138. ; *    Reading is less straightforward because your root object and
  139. ; *    any subobjects must be read inside of your TQ3XObjectReadDataMethod. There 
  140. ; *    is an implicit state contained in the file while reading, which you must 
  141. ; *    be aware of. When you first enter the read method, you must physically 
  142. ; *    read in your data format using the primitives routines until
  143. ; *    
  144. ; *    Q3File_IsEndOfData(file) == kQ3True
  145. ; *    
  146. ; *    Generally, your data format should be self-descriptive such that you do not
  147. ; *    need to call Q3File_IsEndOfData to determine if you are done reading. 
  148. ; *    However, this call is useful for determining zero-sized object or 
  149. ; *    determining the end of an object's data.
  150. ; *    
  151. ; *    Once you have read in all the data, you may collect subobjects. A metafile
  152. ; *    object ONLY has subobjects if it is in a container. The call
  153. ; *    
  154. ; *    Q3File_IsEndOfContainer(file)
  155. ; *    
  156. ; *    returns kQ3False if subobjects exist, and kQ3True if subobjects do not 
  157. ; *    exist.
  158. ; *    
  159. ; *    At this point, you may use
  160. ; *    
  161. ; *    Q3File_GetNextObjectType
  162. ; *    Q3File_IsNextObjectOfType
  163. ; *    Q3File_ReadObject
  164. ; *    Q3File_SkipObject
  165. ; *    
  166. ; *    to iterate through the subobjects until Q3File_IsEndOfContainer(file) 
  167. ; *    is kQ3True.
  168. ; * 
  169. ; 
  170.  
  171.  
  172. ; 
  173. ; * IO Methods
  174. ; 
  175.  
  176.  
  177. kQ3XMethodTypeObjectFileVersion    EQU        'vers'                ; version 
  178. kQ3XMethodTypeObjectTraverse    EQU        'trvs'                ; byte count 
  179. kQ3XMethodTypeObjectTraverseData EQU    'trvd'                ; byte count 
  180. kQ3XMethodTypeObjectWrite        EQU        'writ'                ; Dump info to file 
  181. kQ3XMethodTypeObjectReadData    EQU        'rddt'                ; Read info from file into buffer or, attach read data to parent 
  182. kQ3XMethodTypeObjectRead        EQU        'read'
  183. kQ3XMethodTypeObjectAttach        EQU        'attc'
  184. ; 
  185. ; *    TQ3XObjectTraverseMethod
  186. ; *
  187. ; *    For "elements" (meaning "attributes, too), you will be passed NULL for 
  188. ; *    object. Sorry, custom objects will be available in the next major revision.
  189. ; *
  190. ; *    The "data" is a pointer to your internal element data.
  191. ; *
  192. ; *    The view is the current traversal view.
  193. ; 
  194.  
  195. ; 
  196. ; *  TQ3XObjectTraverseDataMethod
  197. ; 
  198.  
  199. ; 
  200. ; *  TQ3XObjectWriteMethod
  201. ; 
  202.  
  203. ; 
  204. ; *  Custom object writing 
  205. ; 
  206.  
  207. ;
  208. ; extern TQ3Status Q3XView_SubmitWriteData(TQ3ViewObject view, TQ3Size size, void *data, TQ3XDataDeleteMethod deleteData)
  209. ;
  210.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  211.         IMPORT_CFM_FUNCTION Q3XView_SubmitWriteData
  212.     ENDIF
  213.  
  214. ;
  215. ; extern TQ3Status Q3XView_SubmitSubObjectData(TQ3ViewObject view, TQ3XObjectClass objectClass, unsigned long size, void *data, TQ3XDataDeleteMethod deleteData)
  216. ;
  217.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  218.         IMPORT_CFM_FUNCTION Q3XView_SubmitSubObjectData
  219.     ENDIF
  220.  
  221. ; 
  222. ; *  TQ3XObjectReadMethod
  223. ; 
  224.  
  225. ; 
  226. ; *    TQ3XObjectReadDataMethod
  227. ; *
  228. ; *  For "elements" (meaning "attributes", too), you must allocate stack space 
  229. ; *    and call Q3Set_Add on "parentObject", which is an TQ3SetObject.
  230. ; *
  231. ; *    Otherwise, parentObject is whatever object your element is a subobject of...
  232. ; 
  233.  
  234. ; 
  235. ; *  TQ3XObjectAttachMethod
  236. ; 
  237.  
  238.  
  239.  
  240. ; ******************************************************************************
  241. ; **                                                                              **
  242. ; **                                Versioning                                     **
  243. ; **                                                                              **
  244. ; ****************************************************************************
  245.  
  246. ; typedef unsigned long                 TQ3FileVersion
  247.  
  248.  
  249. ; ******************************************************************************
  250. ; **                                                                              **
  251. ; **                                File Routines                                 **
  252. ; **                                                                              **
  253. ; ****************************************************************************
  254.  
  255. ; 
  256. ; * Creation and accessors
  257. ; 
  258.  
  259. ;
  260. ; extern TQ3FileObject Q3File_New(void )
  261. ;
  262.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  263.         IMPORT_CFM_FUNCTION Q3File_New
  264.     ENDIF
  265.  
  266. ;
  267. ; extern TQ3Status Q3File_GetStorage(TQ3FileObject theFile, TQ3StorageObject *storage)
  268. ;
  269.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  270.         IMPORT_CFM_FUNCTION Q3File_GetStorage
  271.     ENDIF
  272.  
  273. ;
  274. ; extern TQ3Status Q3File_SetStorage(TQ3FileObject theFile, TQ3StorageObject storage)
  275. ;
  276.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  277.         IMPORT_CFM_FUNCTION Q3File_SetStorage
  278.     ENDIF
  279.  
  280. ; 
  281. ; * Opening, and accessing "open" state, closing/cancelling
  282. ; 
  283.  
  284. ;
  285. ; extern TQ3Status Q3File_OpenRead(TQ3FileObject theFile, TQ3FileMode *mode)
  286. ;
  287.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  288.         IMPORT_CFM_FUNCTION Q3File_OpenRead
  289.     ENDIF
  290.  
  291. ;
  292. ; extern TQ3Status Q3File_OpenWrite(TQ3FileObject theFile, TQ3FileMode mode)
  293. ;
  294.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  295.         IMPORT_CFM_FUNCTION Q3File_OpenWrite
  296.     ENDIF
  297.  
  298. ;
  299. ; extern TQ3Status Q3File_IsOpen(TQ3FileObject theFile, TQ3Boolean *isOpen)
  300. ;
  301.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  302.         IMPORT_CFM_FUNCTION Q3File_IsOpen
  303.     ENDIF
  304.  
  305. ;
  306. ; extern TQ3Status Q3File_GetMode(TQ3FileObject theFile, TQ3FileMode *mode)
  307. ;
  308.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  309.         IMPORT_CFM_FUNCTION Q3File_GetMode
  310.     ENDIF
  311.  
  312. ;
  313. ; extern TQ3Status Q3File_GetVersion(TQ3FileObject theFile, TQ3FileVersion *version)
  314. ;
  315.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  316.         IMPORT_CFM_FUNCTION Q3File_GetVersion
  317.     ENDIF
  318.  
  319. ;
  320. ; extern TQ3Status Q3File_Close(TQ3FileObject theFile)
  321. ;
  322.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  323.         IMPORT_CFM_FUNCTION Q3File_Close
  324.     ENDIF
  325.  
  326. ;
  327. ; extern TQ3Status Q3File_Cancel(TQ3FileObject theFile)
  328. ;
  329.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  330.         IMPORT_CFM_FUNCTION Q3File_Cancel
  331.     ENDIF
  332.  
  333. ; 
  334. ; * Writing (Application)
  335. ; 
  336.  
  337. ;
  338. ; extern TQ3Status Q3View_StartWriting(TQ3ViewObject view, TQ3FileObject theFile)
  339. ;
  340.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  341.         IMPORT_CFM_FUNCTION Q3View_StartWriting
  342.     ENDIF
  343.  
  344. ;
  345. ; extern TQ3ViewStatus Q3View_EndWriting(TQ3ViewObject view)
  346. ;
  347.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  348.         IMPORT_CFM_FUNCTION Q3View_EndWriting
  349.     ENDIF
  350.  
  351. ; 
  352. ; * Reading (Application)
  353. ; 
  354.  
  355. ;
  356. ; extern TQ3ObjectType Q3File_GetNextObjectType(TQ3FileObject theFile)
  357. ;
  358.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  359.         IMPORT_CFM_FUNCTION Q3File_GetNextObjectType
  360.     ENDIF
  361.  
  362. ;
  363. ; extern TQ3Boolean Q3File_IsNextObjectOfType(TQ3FileObject theFile, TQ3ObjectType ofType)
  364. ;
  365.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  366.         IMPORT_CFM_FUNCTION Q3File_IsNextObjectOfType
  367.     ENDIF
  368.  
  369. ;
  370. ; extern TQ3Object Q3File_ReadObject(TQ3FileObject theFile)
  371. ;
  372.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  373.         IMPORT_CFM_FUNCTION Q3File_ReadObject
  374.     ENDIF
  375.  
  376. ;
  377. ; extern TQ3Status Q3File_SkipObject(TQ3FileObject theFile)
  378. ;
  379.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  380.         IMPORT_CFM_FUNCTION Q3File_SkipObject
  381.     ENDIF
  382.  
  383. ;
  384. ; extern TQ3Boolean Q3File_IsEndOfData(TQ3FileObject theFile)
  385. ;
  386.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  387.         IMPORT_CFM_FUNCTION Q3File_IsEndOfData
  388.     ENDIF
  389.  
  390. ;
  391. ; extern TQ3Boolean Q3File_IsEndOfContainer(TQ3FileObject theFile, TQ3Object rootObject)
  392. ;
  393.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  394.         IMPORT_CFM_FUNCTION Q3File_IsEndOfContainer
  395.     ENDIF
  396.  
  397. ;
  398. ; extern TQ3Boolean Q3File_IsEndOfFile(TQ3FileObject theFile)
  399. ;
  400.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  401.         IMPORT_CFM_FUNCTION Q3File_IsEndOfFile
  402.     ENDIF
  403.  
  404. ;     
  405. ; *  External file references
  406. ; 
  407.  
  408. ;
  409. ; extern TQ3Status Q3File_MarkAsExternalReference(TQ3FileObject theFile, TQ3SharedObject sharedObject)
  410. ;
  411.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  412.         IMPORT_CFM_FUNCTION Q3File_MarkAsExternalReference
  413.     ENDIF
  414.  
  415. ;
  416. ; extern TQ3GroupObject Q3File_GetExternalReferences(TQ3FileObject theFile)
  417. ;
  418.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  419.         IMPORT_CFM_FUNCTION Q3File_GetExternalReferences
  420.     ENDIF
  421.  
  422. ;     
  423. ; *  Tracking editing in read-in objects with custom elements
  424. ; 
  425.  
  426. ;
  427. ; extern TQ3Status Q3Shared_ClearEditTracking(TQ3SharedObject sharedObject)
  428. ;
  429.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  430.         IMPORT_CFM_FUNCTION Q3Shared_ClearEditTracking
  431.     ENDIF
  432.  
  433. ;
  434. ; extern TQ3Boolean Q3Shared_GetEditTrackingState(TQ3SharedObject sharedObject)
  435. ;
  436.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  437.         IMPORT_CFM_FUNCTION Q3Shared_GetEditTrackingState
  438.     ENDIF
  439.  
  440. ;     
  441. ; *  Reading objects inside a group one-by-one
  442. ; 
  443.  
  444.  
  445. ; typedef long                            TQ3FileReadGroupStateMasks
  446. kQ3FileReadWholeGroup            EQU        0
  447. kQ3FileReadObjectsInGroup        EQU        $01
  448. kQ3FileCurrentlyInsideGroup        EQU        $02
  449. ; typedef unsigned long                 TQ3FileReadGroupState
  450.  
  451. ;
  452. ; extern TQ3Status Q3File_SetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState readGroupState)
  453. ;
  454.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  455.         IMPORT_CFM_FUNCTION Q3File_SetReadInGroup
  456.     ENDIF
  457.  
  458. ;
  459. ; extern TQ3Status Q3File_GetReadInGroup(TQ3FileObject theFile, TQ3FileReadGroupState *readGroupState)
  460. ;
  461.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  462.         IMPORT_CFM_FUNCTION Q3File_GetReadInGroup
  463.     ENDIF
  464.  
  465.  
  466. ; 
  467. ; * Idling
  468. ; 
  469.  
  470. ;
  471. ; extern TQ3Status Q3File_SetIdleMethod(TQ3FileObject theFile, TQ3FileIdleMethod idle, const void *idleData)
  472. ;
  473.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  474.         IMPORT_CFM_FUNCTION Q3File_SetIdleMethod
  475.     ENDIF
  476.  
  477.  
  478. ; ******************************************************************************
  479. ; **                                                                              **
  480. ; **                                Primitives Routines                             **
  481. ; **                                                                              **
  482. ; ****************************************************************************
  483.  
  484. ;
  485. ; extern TQ3Status Q3NewLine_Write(TQ3FileObject theFile)
  486. ;
  487.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  488.         IMPORT_CFM_FUNCTION Q3NewLine_Write
  489.     ENDIF
  490.  
  491. ;
  492. ; extern TQ3Status Q3Uns8_Read(TQ3Uns8 *data, TQ3FileObject theFile)
  493. ;
  494.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  495.         IMPORT_CFM_FUNCTION Q3Uns8_Read
  496.     ENDIF
  497.  
  498. ;
  499. ; extern TQ3Status Q3Uns8_Write(TQ3Uns8 data, TQ3FileObject theFile)
  500. ;
  501.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  502.         IMPORT_CFM_FUNCTION Q3Uns8_Write
  503.     ENDIF
  504.  
  505. ;
  506. ; extern TQ3Status Q3Uns16_Read(TQ3Uns16 *data, TQ3FileObject theFile)
  507. ;
  508.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  509.         IMPORT_CFM_FUNCTION Q3Uns16_Read
  510.     ENDIF
  511.  
  512. ;
  513. ; extern TQ3Status Q3Uns16_Write(TQ3Uns16 data, TQ3FileObject theFile)
  514. ;
  515.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  516.         IMPORT_CFM_FUNCTION Q3Uns16_Write
  517.     ENDIF
  518.  
  519. ;
  520. ; extern TQ3Status Q3Uns32_Read(TQ3Uns32 *data, TQ3FileObject theFile)
  521. ;
  522.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  523.         IMPORT_CFM_FUNCTION Q3Uns32_Read
  524.     ENDIF
  525.  
  526. ;
  527. ; extern TQ3Status Q3Uns32_Write(TQ3Uns32 data, TQ3FileObject theFile)
  528. ;
  529.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  530.         IMPORT_CFM_FUNCTION Q3Uns32_Write
  531.     ENDIF
  532.  
  533. ;
  534. ; extern TQ3Status Q3Int8_Read(TQ3Int8 *data, TQ3FileObject theFile)
  535. ;
  536.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  537.         IMPORT_CFM_FUNCTION Q3Int8_Read
  538.     ENDIF
  539.  
  540. ;
  541. ; extern TQ3Status Q3Int8_Write(TQ3Int8 data, TQ3FileObject theFile)
  542. ;
  543.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  544.         IMPORT_CFM_FUNCTION Q3Int8_Write
  545.     ENDIF
  546.  
  547. ;
  548. ; extern TQ3Status Q3Int16_Read(TQ3Int16 *data, TQ3FileObject theFile)
  549. ;
  550.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  551.         IMPORT_CFM_FUNCTION Q3Int16_Read
  552.     ENDIF
  553.  
  554. ;
  555. ; extern TQ3Status Q3Int16_Write(TQ3Int16 data, TQ3FileObject theFile)
  556. ;
  557.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  558.         IMPORT_CFM_FUNCTION Q3Int16_Write
  559.     ENDIF
  560.  
  561. ;
  562. ; extern TQ3Status Q3Int32_Read(TQ3Int32 *data, TQ3FileObject theFile)
  563. ;
  564.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  565.         IMPORT_CFM_FUNCTION Q3Int32_Read
  566.     ENDIF
  567.  
  568. ;
  569. ; extern TQ3Status Q3Int32_Write(TQ3Int32 data, TQ3FileObject theFile)
  570. ;
  571.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  572.         IMPORT_CFM_FUNCTION Q3Int32_Write
  573.     ENDIF
  574.  
  575. ;
  576. ; extern TQ3Status Q3Uns64_Read(TQ3Uns64 *data, TQ3FileObject theFile)
  577. ;
  578.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  579.         IMPORT_CFM_FUNCTION Q3Uns64_Read
  580.     ENDIF
  581.  
  582. ;
  583. ; extern TQ3Status Q3Uns64_Write(TQ3Uns64 data, TQ3FileObject theFile)
  584. ;
  585.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  586.         IMPORT_CFM_FUNCTION Q3Uns64_Write
  587.     ENDIF
  588.  
  589. ;
  590. ; extern TQ3Status Q3Int64_Read(TQ3Int64 *data, TQ3FileObject theFile)
  591. ;
  592.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  593.         IMPORT_CFM_FUNCTION Q3Int64_Read
  594.     ENDIF
  595.  
  596. ;
  597. ; extern TQ3Status Q3Int64_Write(TQ3Int64 data, TQ3FileObject theFile)
  598. ;
  599.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  600.         IMPORT_CFM_FUNCTION Q3Int64_Write
  601.     ENDIF
  602.  
  603. ;
  604. ; extern TQ3Status Q3Float32_Read(TQ3Float32 *data, TQ3FileObject theFile)
  605. ;
  606.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  607.         IMPORT_CFM_FUNCTION Q3Float32_Read
  608.     ENDIF
  609.  
  610. ;
  611. ; extern TQ3Status Q3Float32_Write(TQ3Float32 data, TQ3FileObject theFile)
  612. ;
  613.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  614.         IMPORT_CFM_FUNCTION Q3Float32_Write
  615.     ENDIF
  616.  
  617. ;
  618. ; extern TQ3Status Q3Float64_Read(TQ3Float64 *data, TQ3FileObject theFile)
  619. ;
  620.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  621.         IMPORT_CFM_FUNCTION Q3Float64_Read
  622.     ENDIF
  623.  
  624. ;
  625. ; extern TQ3Status Q3Float64_Write(TQ3Float64 data, TQ3FileObject theFile)
  626. ;
  627.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  628.         IMPORT_CFM_FUNCTION Q3Float64_Write
  629.     ENDIF
  630.  
  631. ;
  632. ; extern TQ3Size Q3Size_Pad(TQ3Size size)
  633. ;
  634.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  635.         IMPORT_CFM_FUNCTION Q3Size_Pad
  636.     ENDIF
  637.  
  638. ; 
  639. ; * Pass a pointer to a buffer of kQ3StringMaximumLength bytes
  640. ; 
  641.  
  642. ;
  643. ; extern TQ3Status Q3String_Read(char *data, unsigned long *length, TQ3FileObject theFile)
  644. ;
  645.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  646.         IMPORT_CFM_FUNCTION Q3String_Read
  647.     ENDIF
  648.  
  649. ;
  650. ; extern TQ3Status Q3String_Write(const char *data, TQ3FileObject theFile)
  651. ;
  652.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  653.         IMPORT_CFM_FUNCTION Q3String_Write
  654.     ENDIF
  655.  
  656. ;  
  657. ; * This call will read Q3Size_Pad(size) bytes,
  658. ; *    but only place size bytes into data.
  659. ; 
  660.  
  661. ;
  662. ; extern TQ3Status Q3RawData_Read(unsigned char *data, unsigned long size, TQ3FileObject theFile)
  663. ;
  664.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  665.         IMPORT_CFM_FUNCTION Q3RawData_Read
  666.     ENDIF
  667.  
  668. ;  
  669. ; * This call will write Q3Size_Pad(size) bytes,
  670. ; *    adding 0's to pad to the nearest 4 byte boundary.
  671. ; 
  672.  
  673. ;
  674. ; extern TQ3Status Q3RawData_Write(const unsigned char *data, unsigned long size, TQ3FileObject theFile)
  675. ;
  676.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  677.         IMPORT_CFM_FUNCTION Q3RawData_Write
  678.     ENDIF
  679.  
  680. ; ******************************************************************************
  681. ; **                                                                              **
  682. ; **                        Convenient Primitives Routines                         **
  683. ; **                                                                              **
  684. ; ****************************************************************************
  685.  
  686. ;
  687. ; extern TQ3Status Q3Point2D_Read(TQ3Point2D *point2D, TQ3FileObject theFile)
  688. ;
  689.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  690.         IMPORT_CFM_FUNCTION Q3Point2D_Read
  691.     ENDIF
  692.  
  693. ;
  694. ; extern TQ3Status Q3Point2D_Write(const TQ3Point2D *point2D, TQ3FileObject theFile)
  695. ;
  696.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  697.         IMPORT_CFM_FUNCTION Q3Point2D_Write
  698.     ENDIF
  699.  
  700. ;
  701. ; extern TQ3Status Q3Point3D_Read(TQ3Point3D *point3D, TQ3FileObject theFile)
  702. ;
  703.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  704.         IMPORT_CFM_FUNCTION Q3Point3D_Read
  705.     ENDIF
  706.  
  707. ;
  708. ; extern TQ3Status Q3Point3D_Write(const TQ3Point3D *point3D, TQ3FileObject theFile)
  709. ;
  710.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  711.         IMPORT_CFM_FUNCTION Q3Point3D_Write
  712.     ENDIF
  713.  
  714. ;
  715. ; extern TQ3Status Q3RationalPoint3D_Read(TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  716. ;
  717.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  718.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Read
  719.     ENDIF
  720.  
  721. ;
  722. ; extern TQ3Status Q3RationalPoint3D_Write(const TQ3RationalPoint3D *point3D, TQ3FileObject theFile)
  723. ;
  724.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  725.         IMPORT_CFM_FUNCTION Q3RationalPoint3D_Write
  726.     ENDIF
  727.  
  728. ;
  729. ; extern TQ3Status Q3RationalPoint4D_Read(TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  730. ;
  731.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  732.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Read
  733.     ENDIF
  734.  
  735. ;
  736. ; extern TQ3Status Q3RationalPoint4D_Write(const TQ3RationalPoint4D *point4D, TQ3FileObject theFile)
  737. ;
  738.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  739.         IMPORT_CFM_FUNCTION Q3RationalPoint4D_Write
  740.     ENDIF
  741.  
  742. ;
  743. ; extern TQ3Status Q3Vector2D_Read(TQ3Vector2D *vector2D, TQ3FileObject theFile)
  744. ;
  745.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  746.         IMPORT_CFM_FUNCTION Q3Vector2D_Read
  747.     ENDIF
  748.  
  749. ;
  750. ; extern TQ3Status Q3Vector2D_Write(const TQ3Vector2D *vector2D, TQ3FileObject theFile)
  751. ;
  752.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  753.         IMPORT_CFM_FUNCTION Q3Vector2D_Write
  754.     ENDIF
  755.  
  756. ;
  757. ; extern TQ3Status Q3Vector3D_Read(TQ3Vector3D *vector3D, TQ3FileObject theFile)
  758. ;
  759.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  760.         IMPORT_CFM_FUNCTION Q3Vector3D_Read
  761.     ENDIF
  762.  
  763. ;
  764. ; extern TQ3Status Q3Vector3D_Write(const TQ3Vector3D *vector3D, TQ3FileObject theFile)
  765. ;
  766.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  767.         IMPORT_CFM_FUNCTION Q3Vector3D_Write
  768.     ENDIF
  769.  
  770. ;
  771. ; extern TQ3Status Q3Matrix4x4_Read(TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  772. ;
  773.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  774.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Read
  775.     ENDIF
  776.  
  777. ;
  778. ; extern TQ3Status Q3Matrix4x4_Write(const TQ3Matrix4x4 *matrix4x4, TQ3FileObject theFile)
  779. ;
  780.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  781.         IMPORT_CFM_FUNCTION Q3Matrix4x4_Write
  782.     ENDIF
  783.  
  784. ;
  785. ; extern TQ3Status Q3Tangent2D_Read(TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  786. ;
  787.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  788.         IMPORT_CFM_FUNCTION Q3Tangent2D_Read
  789.     ENDIF
  790.  
  791. ;
  792. ; extern TQ3Status Q3Tangent2D_Write(const TQ3Tangent2D *tangent2D, TQ3FileObject theFile)
  793. ;
  794.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  795.         IMPORT_CFM_FUNCTION Q3Tangent2D_Write
  796.     ENDIF
  797.  
  798. ;
  799. ; extern TQ3Status Q3Tangent3D_Read(TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  800. ;
  801.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  802.         IMPORT_CFM_FUNCTION Q3Tangent3D_Read
  803.     ENDIF
  804.  
  805. ;
  806. ; extern TQ3Status Q3Tangent3D_Write(const TQ3Tangent3D *tangent3D, TQ3FileObject theFile)
  807. ;
  808.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  809.         IMPORT_CFM_FUNCTION Q3Tangent3D_Write
  810.     ENDIF
  811.  
  812. ;     This call affects only text Files - it is a no-op in binary files 
  813. ;
  814. ; extern TQ3Status Q3Comment_Write(char *comment, TQ3FileObject theFile)
  815. ;
  816.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  817.         IMPORT_CFM_FUNCTION Q3Comment_Write
  818.     ENDIF
  819.  
  820. ; ******************************************************************************
  821. ; **                                                                              **
  822. ; **                                Unknown Object                                 **
  823. ; **                                                                              **
  824. ; **        Unknown objects are generated when reading files which contain         **
  825. ; **        custom data which has not been registered in the current             **
  826. ; **        instantiation of QuickDraw 3D.                                         **
  827. ; **                                                                              **
  828. ; ****************************************************************************
  829.  
  830. ;
  831. ; extern TQ3ObjectType Q3Unknown_GetType(TQ3UnknownObject unknownObject)
  832. ;
  833.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  834.         IMPORT_CFM_FUNCTION Q3Unknown_GetType
  835.     ENDIF
  836.  
  837. ;
  838. ; extern TQ3Status Q3Unknown_GetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean *isDirty)
  839. ;
  840.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  841.         IMPORT_CFM_FUNCTION Q3Unknown_GetDirtyState
  842.     ENDIF
  843.  
  844. ;
  845. ; extern TQ3Status Q3Unknown_SetDirtyState(TQ3UnknownObject unknownObject, TQ3Boolean isDirty)
  846. ;
  847.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  848.         IMPORT_CFM_FUNCTION Q3Unknown_SetDirtyState
  849.     ENDIF
  850.  
  851.  
  852. ; ******************************************************************************
  853. ; **                                                                              **
  854. ; **                            Unknown Text Routines                             **
  855. ; **                                                                              **
  856. ; ****************************************************************************
  857.  
  858. TQ3UnknownTextData        RECORD 0
  859. objectName                 ds.l    1                ; offset: $0 (0)        ;  '\0' terminated 
  860. contents                 ds.l    1                ; offset: $4 (4)        ;  '\0' terminated 
  861. sizeof                     EQU *                    ; size:   $8 (8)
  862.                         ENDR
  863. ;
  864. ; extern TQ3Status Q3UnknownText_GetData(TQ3UnknownObject unknownObject, TQ3UnknownTextData *unknownTextData)
  865. ;
  866.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  867.         IMPORT_CFM_FUNCTION Q3UnknownText_GetData
  868.     ENDIF
  869.  
  870. ;
  871. ; extern TQ3Status Q3UnknownText_EmptyData(TQ3UnknownTextData *unknownTextData)
  872. ;
  873.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  874.         IMPORT_CFM_FUNCTION Q3UnknownText_EmptyData
  875.     ENDIF
  876.  
  877.  
  878. ; ******************************************************************************
  879. ; **                                                                              **
  880. ; **                            Unknown Binary Routines                             **
  881. ; **                                                                              **
  882. ; ****************************************************************************
  883.  
  884. TQ3UnknownBinaryData    RECORD 0
  885. objectType                 ds.l    1                ; offset: $0 (0)
  886. size                     ds.l    1                ; offset: $4 (4)
  887. byteOrder                 ds.l    1                ; offset: $8 (8)
  888. contents                 ds.l    1                ; offset: $C (12)
  889. sizeof                     EQU *                    ; size:   $10 (16)
  890.                         ENDR
  891. ;
  892. ; extern TQ3Status Q3UnknownBinary_GetData(TQ3UnknownObject unknownObject, TQ3UnknownBinaryData *unknownBinaryData)
  893. ;
  894.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  895.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetData
  896.     ENDIF
  897.  
  898. ;
  899. ; extern TQ3Status Q3UnknownBinary_EmptyData(TQ3UnknownBinaryData *unknownBinaryData)
  900. ;
  901.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  902.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyData
  903.     ENDIF
  904.  
  905.  
  906. ;
  907. ; extern TQ3Status Q3UnknownBinary_GetTypeString(TQ3UnknownObject unknownObject, char **typeString)
  908. ;
  909.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  910.         IMPORT_CFM_FUNCTION Q3UnknownBinary_GetTypeString
  911.     ENDIF
  912.  
  913. ;
  914. ; extern TQ3Status Q3UnknownBinary_EmptyTypeString(char **typeString)
  915. ;
  916.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  917.         IMPORT_CFM_FUNCTION Q3UnknownBinary_EmptyTypeString
  918.     ENDIF
  919.  
  920. ; ******************************************************************************
  921. ; **                                                                              **
  922. ; **                            ViewHints routines                                 **
  923. ; **                                                                              **
  924. ; **        ViewHints are an object in a metafile to give you some hints on how     **
  925. ; **        to render a scene.    You may create a view with any of the objects     **
  926. ; **        retrieved from it, or you can just throw it away.                     **
  927. ; **                                                                              **
  928. ; **        To write a view hints to a file, create a view hints object from a     **
  929. ; **        view and write the view hints.                                         **
  930. ; **                                                                              **
  931. ; ****************************************************************************
  932.  
  933. ;
  934. ; extern TQ3ViewHintsObject Q3ViewHints_New(TQ3ViewObject view)
  935. ;
  936.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  937.         IMPORT_CFM_FUNCTION Q3ViewHints_New
  938.     ENDIF
  939.  
  940. ;
  941. ; extern TQ3Status Q3ViewHints_SetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject renderer)
  942. ;
  943.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  944.         IMPORT_CFM_FUNCTION Q3ViewHints_SetRenderer
  945.     ENDIF
  946.  
  947. ;
  948. ; extern TQ3Status Q3ViewHints_GetRenderer(TQ3ViewHintsObject viewHints, TQ3RendererObject *renderer)
  949. ;
  950.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  951.         IMPORT_CFM_FUNCTION Q3ViewHints_GetRenderer
  952.     ENDIF
  953.  
  954. ;
  955. ; extern TQ3Status Q3ViewHints_SetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject camera)
  956. ;
  957.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  958.         IMPORT_CFM_FUNCTION Q3ViewHints_SetCamera
  959.     ENDIF
  960.  
  961. ;
  962. ; extern TQ3Status Q3ViewHints_GetCamera(TQ3ViewHintsObject viewHints, TQ3CameraObject *camera)
  963. ;
  964.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  965.         IMPORT_CFM_FUNCTION Q3ViewHints_GetCamera
  966.     ENDIF
  967.  
  968. ;
  969. ; extern TQ3Status Q3ViewHints_SetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject lightGroup)
  970. ;
  971.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  972.         IMPORT_CFM_FUNCTION Q3ViewHints_SetLightGroup
  973.     ENDIF
  974.  
  975. ;
  976. ; extern TQ3Status Q3ViewHints_GetLightGroup(TQ3ViewHintsObject viewHints, TQ3GroupObject *lightGroup)
  977. ;
  978.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  979.         IMPORT_CFM_FUNCTION Q3ViewHints_GetLightGroup
  980.     ENDIF
  981.  
  982. ;
  983. ; extern TQ3Status Q3ViewHints_SetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet attributeSet)
  984. ;
  985.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  986.         IMPORT_CFM_FUNCTION Q3ViewHints_SetAttributeSet
  987.     ENDIF
  988.  
  989. ;
  990. ; extern TQ3Status Q3ViewHints_GetAttributeSet(TQ3ViewHintsObject viewHints, TQ3AttributeSet *attributeSet)
  991. ;
  992.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  993.         IMPORT_CFM_FUNCTION Q3ViewHints_GetAttributeSet
  994.     ENDIF
  995.  
  996. ;
  997. ; extern TQ3Status Q3ViewHints_SetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  998. ;
  999.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1000.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensionsState
  1001.     ENDIF
  1002.  
  1003. ;
  1004. ; extern TQ3Status Q3ViewHints_GetDimensionsState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1005. ;
  1006.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1007.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensionsState
  1008.     ENDIF
  1009.  
  1010. ;
  1011. ; extern TQ3Status Q3ViewHints_SetDimensions(TQ3ViewHintsObject viewHints, unsigned long width, unsigned long height)
  1012. ;
  1013.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1014.         IMPORT_CFM_FUNCTION Q3ViewHints_SetDimensions
  1015.     ENDIF
  1016.  
  1017. ;
  1018. ; extern TQ3Status Q3ViewHints_GetDimensions(TQ3ViewHintsObject viewHints, unsigned long *width, unsigned long *height)
  1019. ;
  1020.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1021.         IMPORT_CFM_FUNCTION Q3ViewHints_GetDimensions
  1022.     ENDIF
  1023.  
  1024. ;
  1025. ; extern TQ3Status Q3ViewHints_SetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean isValid)
  1026. ;
  1027.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1028.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMaskState
  1029.     ENDIF
  1030.  
  1031. ;
  1032. ; extern TQ3Status Q3ViewHints_GetMaskState(TQ3ViewHintsObject viewHints, TQ3Boolean *isValid)
  1033. ;
  1034.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1035.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMaskState
  1036.     ENDIF
  1037.  
  1038. ;
  1039. ; extern TQ3Status Q3ViewHints_SetMask(TQ3ViewHintsObject viewHints, const TQ3Bitmap *mask)
  1040. ;
  1041.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1042.         IMPORT_CFM_FUNCTION Q3ViewHints_SetMask
  1043.     ENDIF
  1044.  
  1045. ;
  1046. ; extern TQ3Status Q3ViewHints_GetMask(TQ3ViewHintsObject viewHints, TQ3Bitmap *mask)
  1047. ;
  1048.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1049.         IMPORT_CFM_FUNCTION Q3ViewHints_GetMask
  1050.     ENDIF
  1051.  
  1052. ;  Call Q3Bitmap_Empty when done with the mask    
  1053. ;
  1054. ; extern TQ3Status Q3ViewHints_SetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod clearMethod)
  1055. ;
  1056.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1057.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageMethod
  1058.     ENDIF
  1059.  
  1060. ;
  1061. ; extern TQ3Status Q3ViewHints_GetClearImageMethod(TQ3ViewHintsObject viewHints, TQ3DrawContextClearImageMethod *clearMethod)
  1062. ;
  1063.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1064.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageMethod
  1065.     ENDIF
  1066.  
  1067. ;
  1068. ; extern TQ3Status Q3ViewHints_SetClearImageColor(TQ3ViewHintsObject viewHints, const TQ3ColorARGB *color)
  1069. ;
  1070.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1071.         IMPORT_CFM_FUNCTION Q3ViewHints_SetClearImageColor
  1072.     ENDIF
  1073.  
  1074. ;
  1075. ; extern TQ3Status Q3ViewHints_GetClearImageColor(TQ3ViewHintsObject viewHints, TQ3ColorARGB *color)
  1076. ;
  1077.     IF TARGET_OS_MAC ** TARGET_RT_MAC_CFM THEN
  1078.         IMPORT_CFM_FUNCTION Q3ViewHints_GetClearImageColor
  1079.     ENDIF
  1080.  
  1081.  
  1082.  
  1083.     ENDIF ; __QD3DIO__ 
  1084.  
  1085.